home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / rectf.z / rectf
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. rrrreeeeccccttttffff((((3333GGGG))))                                                            rrrreeeeccccttttffff((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rrrreeeeccccttttffff,,,, rrrreeeeccccttttffffiiii,,,, rrrreeeeccccttttffffssss - fills a rectangular area
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee rrrreeeeccccttttffff((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  13.      rrrreeeeaaaallll xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222
  14.  
  15.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee rrrreeeeccccttttffffiiii((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  16.      iiiinnnntttteeeeggggeeeerrrr****4444 xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222
  17.  
  18.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee rrrreeeeccccttttffffssss((((xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222))))
  19.      iiiinnnntttteeeeggggeeeerrrr****2222 xxxx1111,,,, yyyy1111,,,, xxxx2222,,,, yyyy2222
  20.  
  21.      All of the above routines are functionally the same.  They differ only in
  22.      the type declarations of their parameters.
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _x_1   expects the x coordinate of one corner of the rectangle that is to
  26.           be drawn.
  27.  
  28.      _y_1   expects the y coordinate of one corner of the rectangle that is to
  29.           be drawn.
  30.  
  31.      _x_2   expects the x coordinate of the opposite corner of the rectangle
  32.           that is to be drawn.
  33.  
  34.      _y_2   expects the y coordinate of the opposite corner of the rectangle
  35.           that is to be drawn.
  36.  
  37. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.      rrrreeeecccctttt draws a filled rectangle in the _x-_y plane with _z assumed to be zero.
  39.      The sides of the rectangle are parallel to the _x and _y axes.  To create a
  40.      rectangle that does not lie in the _x-_y plane, draw the rectangle in the
  41.      _x-_y plane, then rotate and/or translate the rectangle.
  42.  
  43.      A rectangle is drawn as a single polygon, and therefore inherits all
  44.      properties that affect the drawing of polygons.  These include the
  45.      current color, writemask, fill pattern, shade model, polygon antialiasing
  46.      mode, polygon scan conversion mode, and subpixel mode.  Front-face and
  47.      back-face elimination work correctly with filled rectangles.  The front-
  48.      face of a rectangle faces the positive z half-space when (_x_1, _y_1) is the
  49.      lower-left corner of the rectangle in object coordinates.  Some polygon
  50.      modes are applicable only if old-style scan conversion is defeated.  (See
  51.      note below.)
  52.  
  53.      After rrrreeeeccccttttffff executes, the graphics position is undefined.
  54.  
  55. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  56.      backfa, bgnpol, frontf, glcomp, polymo, polysm, rect, scrsub, setpat,
  57.      shadem, subpix
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrreeeeccccttttffff((((3333GGGG))))                                                            rrrreeeeccccttttffff((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEESSSS
  75.      Previous graphics library implementations set the current graphics
  76.      position to (_x_1, _y_1) after the rectangle was drawn.  Current graphics
  77.      position is now undefined after a rectangle is drawn.
  78.  
  79.      By default rrrreeeeccccttttffff draws a polygon using the old-style scan conversion
  80.      algorithm, rather than the point sampling algorithm used by bbbbggggnnnnppppoooollll and
  81.      eeeennnnddddppppoooollll.  Point sampling is prefered over old-style scan conversion
  82.      because it has higher performance, it results in higher-quality images
  83.      when blending, logical operations, or stenciling are used, and it
  84.      supports new rendering features such as texture mapping, fog, and
  85.      antialiasing.  Call ggggllllccccoooommmmpppp((((GGGGLLLLCCCCOOOOLLLLDDDD,,,,0000)))) to enable point sampling of polygons
  86.      generated by rrrreeeeccccttttffff.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.